Video Descriptor Taxonomy

The Video Descriptor Taxonomy endpoint is an integral part of the Program Video Descriptors feature, and powers the advanced discovery use cases.

This endpoint provides access to the video descriptor taxonomy which is a structured hierarchical relationship (parent/child tree) between descriptors. You can get the full list of Video Descriptors, grouped by Type, using this endpoint. In addition to the Video Descriptor ID and Name, this endpoint provides the following additional information:

  • Immediate parent of a Video Descriptor, using which the hierarchical taxonomy can be built
  • Type (ID and Name) that the video Descriptor belongs to (For example: Video Mood, Theme, Character, …)

Video descriptors are grouped into a specified number types required to completely and accurately describe the video program for advanced discovery use cases. The full list of types is provided here Video Descriptors Types. When additional descriptors and types are released or updated, they is accessible from the same endpoint.

A given Video Descriptor will only belong to a single Type and have a single parent. Programs will only be annotated with Video Descriptors that belong to the Video Descriptor Taxonomy.

See the xsd for a more information about Video Descriptor Taxonomy schema:

http://files.api.gracenote.com/xsd/on_update_videoDescriptorsTaxonomy_3.20.xsd